home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / comms_w / wlprs40.zip / WSOCKAID.ASC < prev    next >
Text File  |  1994-03-16  |  4KB  |  94 lines

  1.                    WSOCKAID.DLL Version 2.0
  2.                                
  3.                         March 16, 1994
  4.                                
  5. This DLL contains functions that are currently missing in the
  6. Windows Sockets 1.1 specification, but which are needed for
  7. some networking applications. Currently this DLL supports only
  8. FTP Software's PC/TCP Version 2.1 and above. For this TCP/IP
  9. stack, all information that WSOCKAID.DLL can give is retrieved
  10. from the PCTCP.INI file (or whatever your PCTCP env. variable
  11. points to). If want to use this DLL together with other stacks
  12. and get errors like "Could not resolve username" from network
  13. applications, look at the list of functions below. For each
  14. inquiry function the information returned to a program can also
  15. be defined in the WIN.INI file by creating a section named
  16. [WSOCKAID] and adding the appropriate entry.
  17.  
  18. The following functions are exported by this DLL:
  19.  
  20. WSAIDGetUsername                    This function retrieves the
  21.                    user name that a PC user has registered
  22.                    with the networking software. If the used
  23.                    networking software has a real Windows
  24.                    network driver (like PC/TCP 2.2 has) and
  25.                    this driver supports the WNetGetUser
  26.                    function, the return value of this function
  27.                    is given to the calling program.  To find
  28.                    out if your networking software has such a
  29.                    driver, look if the [boot] section in
  30.                    SYSTEM.INI contains a network.drv= entry
  31.                    that is not empty.
  32.                    
  33.                    [WSOCKAID]-Entry:  User=<username>
  34.  
  35. WSAIDGetRealname                    This function returns the
  36.                    real name that a PC user has registered
  37.                    with the networking software.
  38.                    
  39.                    [WSOCKAID]-Entry:  Full-Name=<user's real
  40.                    name>
  41.  
  42. WSAIDGetHostname                    This function returns the
  43.                    locally defined host name for the PC
  44.                    (without any domain information appended).
  45.                    
  46.                    [WSOCKAID]-Entry:  Host-Name=<PC's
  47.                    hostname>
  48.  
  49. WSAIDGetDomain                      This function returns the
  50.                    Internet domain that the PC belongs to.
  51.                    
  52.                    [WSOCKAID]-Entry:  Domain=<PC's domain>
  53.  
  54. WSAIDGetDefaultPrinter              This function returns the
  55.                    default LPR network printer as separate
  56.                    queue and server name.
  57.                    
  58.                    [WSOCKAID]-Entry:  LPRQueue=<queue name>
  59.                                    LPRServer=<server name>
  60.  
  61.  
  62. Change Log:
  63.  
  64. Version 1.1a:
  65.  
  66. o  Code segment is no longer FIXED to cure some memory
  67.    contraints.
  68.  
  69. Version 1.1:
  70.  
  71. o  Use the WNetGetUser function for retrieving the user name
  72.    if a network driver is available.
  73.  
  74.  
  75. Copyright:
  76.  
  77. This DLL is Copyright (C) 1993-94 by Thomas Heil.
  78. Redistribution of this DLL is allowed only together with the
  79. documentation (as MS Word for Windows 2.0 .DOC file and as
  80. plain ASCII .ASC file). This software may not be sold by
  81. itself. Applications that use this DLL may be sold together
  82. with the DLL and its documentation included royalty free.
  83.  
  84. If you are a network software vendor and think that your TCP/IP
  85. stack should be supported, please contact me.
  86.  
  87. Author:
  88.  
  89. Thomas Heil
  90. Hindenburgstr. 50
  91. 41352 Korschenbroich
  92. E-Mail: th.heil@kfa-juelich.de (Internet)
  93.  
  94.